home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl760 / scnp785j.lzh / SPLOT.DOC < prev    next >
Text File  |  1992-07-27  |  43KB  |  846 lines
  1.  
  2.                       SPLOT USER INSTRUCTIONS
  3.  
  4.   The program SPLOT (Screen PLOT) will plot two and three dimensional
  5.   data on the screen of an IBM compatible PC with CGA, EGA, VGA or
  6.   Hercules graphics.  The SPLOT program creates a plot by executing a
  7.   sequence of plot commands which can be typed at the keyboard, selected
  8.   from a menu or read from a command file.
  9.  
  10.   If the user types "SPLOT filename" at the DOS prompt the program SPLOT
  11.   will execute plot commands read from the text file "filename".  The
  12.   plot commands specify plot parameters such as type of axes.  Multiple
  13.   sets of data can be plotted on the same plot.  The sets of data can be
  14.   in the command file or in separate data files.  It is assumed that the
  15.   plot commands and data are stored as ASCII text by an editor, word
  16.   processor or a user written program that generates the plot commands
  17.   and/or data as output (as do the example Basic programs FUNGEN.BAS,
  18.   SURFGEN.BAS and CURVEGEN.BAS which generate data and commands to plot
  19.   user programmed functions).
  20.  
  21.   If just "SPLOT" is typed at the DOS prompt then the plot commands can be
  22.   typed at the keyboard.  Pressing the ESC key calls up a menu from which
  23.   the plot commands can be selected using the arrow keys or a mouse (there
  24.   are a few commands that are not accessible from the menu).  The RETURN
  25.   key (or left mouse button) selects a menu item; the ESC key (or right
  26.   mouse button) exits the menu and sub-menus.  The mouse must have a
  27.   Microsoft compatible driver installed that can be called with software
  28.   interrupt # 33h. If calling software interrupt # 33h on a PC with no
  29.   mouse or a nonstandard mouse causes a problem (not likely but just
  30.   in case...) then use of a mouse can be disabled with the DOS command
  31.   "SET SPLOT=NOM"; the equals-sign "=" must immediately follow "SPLOT".
  32.   The SET command must be typed before starting the SPLOT program or it
  33.   can be placed in the PC's AUTOEXEC.BAT file.
  34.  
  35.   On most PCs the program will detect the type of installed graphics card
  36.   (CGA, EGA/VGA or Hercules); unless specified, EGA resolution is used
  37.   with VGA cards.  The graphics card can be specified with the DOS command
  38.   "SET SPLOT=card" where "card" is "CGA", "EGA" "VGA" or "HER".  Use this
  39.   command to specify VGA resolution with a VGA card or if the program
  40.   incorrectly detects the type of graphics card or if the monitor used
  41.   with an EGA or VGA card will only support CGA resolution.  For example,
  42.   the AT&T 6300 Display Enhancement Board is detected as being EGA but it
  43.   is not compatible with EGA; it is compatible with CGA.  To specify that
  44.   the SPLOT program use CGA mode on an AT&T with a DEB, give the DOS
  45.   command "SET SPLOT=CGA".  To use VGA resolution with a VGA card give the
  46.   DOS command "SET SPLOT=VGA"; to also disable use of a mouse give the
  47.   command "SET SPLOT=VGA/NOM".
  48.  
  49.   The following plot commands specify the type of axes.  The x axis is
  50.   the horizontal axis and the y axis is the vertical axis; a
  51.   3-Dimensional plot will also have a z axis perpendicular to the x-y
  52.   plane.  The z axis can also be used as a second vertical axis on
  53.   the right side of a 2-Dimensional plot (see USEZ command):
  54.  
  55.   LINX     - Selects linear x axis (the default).
  56.   LOGX     - Selects log x axis.
  57.   PROBX    - Selects cumulative normal probability x axis.
  58.   LINY     - Selects linear y axis (the default).
  59.   LOGY     - Selects log y axis.
  60.   PROBY    - Selects cumulative normal probability y axis.
  61.   LINZ     - Selects linear z axis (the default).
  62.   LOGZ     - Selects log z axis.
  63.  
  64.   By default the program will automatically set the scales of the axes
  65.   based on the minimum and maximum data values.  The scales of the
  66.   axes can be set by the user with the following commands:
  67.  
  68.   XSTART value    - The x axis will start at "value".
  69.   XEND value      - The x axis will end at "value".
  70.   XSTEP value     - Linear x axis tic marks will be labeled
  71.                     in steps of "value".
  72.   YSTART value    - The y axis will start at "value".
  73.   YEND value      - The y axis will end at "value".
  74.   YSTEP value     - Linear y axis tic marks will be labeled
  75.                     in steps of "value".
  76.   ZSTART value    - The z axis will start at "value".
  77.   ZEND value      - The z axis will end at "value".
  78.   ZSTEP value     - Linear z axis tic marks will be labeled
  79.                     in steps of "value".
  80.  
  81.   Automatic scaling of an axis can be re-enabled by setting the starting
  82.   and ending values equal to the same value, i.e., "XSTART 0" and "XEND
  83.   0".  If the step size is omitted from a linear axis then the program
  84.   will select a step size and adjust the starting and ending values to
  85.   match the step size.  The step size is ignored with a log axis.  A log
  86.   axis will cover a maximum of 8 decades and will always start and
  87.   end at decade boundaries.  Data plotted on a normal probability axis
  88.   must be in the range .0001 to .9999; the axis will be labeled using
  89.   the scaled range .01 to 99.99.
  90.  
  91.   The following commands specify other axes parameters:
  92.  
  93.   XDESCEND     - X axis (on 2D plots) will be labeled in descending order.
  94.   YDESCEND     - Y axis (on 2D plots) will be labeled in descending order.
  95.   XDESCEND OFF - Turns off XDESCEND.
  96.   YDESCEND OFF - Turns off YDESCEND.
  97.   XGRID        - Grid lines will be drawn at labeled x axis tic marks.
  98.   YGRID        - Grid lines will be drawn at labeled y axis tic marks.
  99.   GRIDS        - Turns on both x & y grid lines.
  100.   XGRID OFF    - Turns off display of x axis grid lines.
  101.   YGRID OFF    - Turns off display of y axis grid lines.
  102.   GRIDS OFF    - Turns off both x & y grid lines.
  103.   XBASE value  - Vertical base line will be drawn at "value" on x axis.
  104.   YBASE value  - Horizontal base line will be drawn at "value" on y axis.
  105.   XBASE OFF    - Turns off display of x axis base line.
  106.   YBASE OFF    - Turns off display of y axis base line.
  107.   XTICS n      - Selects "n" minor x axis tic marks between labeled
  108.                  tic marks (default is 4).
  109.   YTICS n      - Selects "n" minor y axis tic marks between labeled
  110.                  tic marks (default is 4).
  111.   ZTICS n      - Selects "n" minor z axis tic marks between labeled
  112.                  tic marks (default is 4).
  113.  
  114.   The following commands are used to read the data:
  115.  
  116.   OPEN filename   - Opens data file "filename" for read.
  117.   READ n          - Reads "n" x y data point pairs.
  118.  
  119.   If no data file is opened then the data is read from the command file
  120.   starting at the line after the READ command.  Multiple READ commands will
  121.   result in multiple sets of data being plotted on the same plot.  There
  122.   can be a maximum of 200 data sets and a maximum of 16000 data points
  123.   per data set; the number of data points per data set will also be limited
  124.   by the amount of available memory.  If "n" is omitted then it defaults
  125.   to 1024; less than "n" data points will be read if the end of the file
  126.   is reached.  Successive data values must be separated by at least one
  127.   non-numeric character other than "+", "-", ".", "E" or "e".  Numbers can
  128.   be in scientific notation with "E" or "e" preceding the exponent.
  129.  
  130.   Data can also be read inwhich all of the x values precede all of the y
  131.   values:
  132.  
  133.   READX n         - Reads "n" x data values; must precede READY command.
  134.   READY n         - Reads "n" y data values; x = 1, 2, 3 ... if no READX.
  135.  
  136.   If multiple READY commands are used to read multiple data sets inwhich
  137.   corresponding y values are associated with the same x value then only
  138.   one READX command is required.  If a READY command is not preceded
  139.   by a READX (or READ) command then the y values will be plotted at even
  140.   intervals.
  141.  
  142.   Multiple sets of data can also be read when the data is arranged in
  143.   the form of a table:
  144.  
  145.   READTAB m n     - Reads "n" rows of table with columns x, y1, ..., ym.
  146.                     The x values must be in the first column and the
  147.                     corresponding y values of data set #1 to data set #m
  148.                     must be in the remaining "m" columns.
  149.   READTABY m n    - Reads "n" rows of table with columns y1, ..., ym.
  150.                     If the command is not preceded by a READX command
  151.                     then the y values will be plotted at even intervals.
  152.  
  153.   Multiple sets of data can be plotted on a 3-Dimensional plot inwhich
  154.   each data set corresponds to a point on the z axis:
  155.  
  156.   READZ n         - Reads "n" z data values for 3-D plots; there should
  157.                     be one z value per data set.
  158.  
  159.   A single 3-Dimensional curve can be plotted inwhich the points on the
  160.   curve are the x-y points in data set #1 and the corresponding z values
  161.   read with the READZ command.  There can be a maximum of 1024 points on
  162.   the 3-D curve.  A table of x y z data values can be read with the
  163.   following command:
  164.  
  165.   READXYZ n       - Reads "n" x y z values as single 3-D data set
  166.                     for plotting as a 3-D curve or 3-D scatter plot.
  167.   READZXY n       - Reads the 3-D data point values in the order z x y.
  168.  
  169.   The following are some more commands used in reading data:
  170.  
  171.   READBARX n      - Reads "n" character strings to be used as the x
  172.                     value labels on a bar graph.
  173.   SKIP n          - Skips "n" lines of the data file.
  174.   SEARCH text     - Reads from the data file until a line containing
  175.                     "text" is read.
  176.   CLOSE           - Closes the data file; opening a new data file will
  177.                     also close a previously opened data tile.
  178.  
  179.   The following commands will generate a curve fit of a data set:
  180.  
  181.   POLY m n        - Generates an mth degree polynomial least squares fit
  182.                     of data set #n.
  183.   EXP m n         - Generates an exponential of an mth degree polynomial
  184.                     least squares fit of data set #n, i.e.,
  185.                              m         m-1
  186.                          Cm X  + Cm-1 X   + ... + C1 X + C0
  187.                     Y = e
  188.   AVG m n         - Generates a nonweighted moving average smooth fit of
  189.                     data set #n using a moving window 2*m+1 data points wide.
  190.                     The data points must be equally spaced.
  191.  
  192.   If "m" is omitted then it defaults to one; a polynomial fit's degree
  193.   cannot be greater than 10.  If "n" is omitted it defaults to the last
  194.   read data set.  The generated data is stored as a new data set.
  195.   The commands "POLY m n x1 y1 x2 y2" and "EXP m n x1 y1 x2 y2" force
  196.   the fitted curve to pass through point (x1,y1) and, optionally, through
  197.   point (x2,y2); the parameters "m" and "n" cannot be omitted.  Example:
  198.   the command "POLY 2 1 0 0" fits a 2nd degree polynomial to data set #1
  199.   with the polynomial forced to pass through the origin.
  200.  
  201.   If the POLY or EXP command is used again to fit the same data set with
  202.   a different degree polynomial or the AVG command is used again with a
  203.   different window size then the new fit will overwrite the old one.
  204.   This feature can be particularly useful when doing a polynomial curve
  205.   fit and it is not known what degree will give the best fit.  When
  206.   entered interactively from the keyboard or selected from the menu, the
  207.   POLY command (and EXP command) will display a statistic, the residual
  208.   variance.  First try a first degree fit with the command "POLY 1" and
  209.   note the residual variance.  Then try a second degree fit with the
  210.   command "POLY 2" and again note the residual variance.  Then try a third
  211.   degree fit, etc.  When a degree is reached inwhich the residual variance
  212.   did not change by much from the previous value then the previous degree
  213.   is the one that should be used.
  214.  
  215.   KEEP            - Keeps the last generated fit from being overwritten
  216.                     by a new one.
  217.   OUTPOLY file    - Outputs the last generated polynomial's coefficients
  218.                     to the specified file; if the file is omitted then
  219.                     the output will be to the screen.
  220.   EXPWT m         - Exponential fits will be weighted with the y data values
  221.                     raised to the mth power; m = 0,1,2.  The default is m=2.
  222.                     If an exponential fit is used to fit a bell shaped curve,
  223.                     for example, then a closer fit of the points at the top
  224.                     of the peak will be made if y squared is used as a weight.
  225.                     If the data is not weighted (m=0) then a closer fit of
  226.                     the tails of the peak will be made.
  227.  
  228.   FFT n           - Calculates the Fast Fourier Transform of data set #n
  229.                     (last data set if n is omitted).  The data must be
  230.                     equally spaced and the number of data points can not be
  231.                     greater than 8192 and should be equal to 2 raised to an
  232.                     integer power, i.e., 2, 4, 8, 16, 32, ... 8192; if not,
  233.                     then the data is padded with the smaller of the two end
  234.                     points.  When the data is plotted it will be fit with a
  235.                     truncated Fourier series by inverting the FFT; the KEEP
  236.                     command will save the fit as a new data set.
  237.   FFTFREQ m       - Specifies the number of FFT frequency components used
  238.                     to fit the data.
  239.   OUTFFT file     - Outputs the FFT coefficients (corresponding to positive
  240.                     frequencies) to the specified file; if the file is omitted
  241.                     then the output will be to the screen.
  242.   PLOTFFT max     - Plots the magnitudes of the FFT coefficients; the
  243.                     optional parameter specifies the maximum value on the
  244.                     FFT axis.
  245.   PLOTFFT2 max    - Plots square of magnitudes of FFT coefficients.
  246.   READFFT m       - Reads m complex FFT coefficients corresponding to zero
  247.                     frequency and m-1 positive frequencies; m-1 should equal
  248.                     2 raised to an integer power.  A new data set is
  249.                     generated by inverting the FFT (the x coordinates will
  250.                     be 0, 1, 2, ...).
  251.  
  252.   The following command is used to plot error bars:
  253.  
  254.   ERRBARS m n     - Data set #m will plot as upper or lower error bars of
  255.                     data set #n.  To have upper and lower error bars for
  256.                     data set #n there must be two sets of data specified
  257.                     as error bars.  One data set must contain lower limits
  258.                     and the other must contain upper limits on the
  259.                     corresponding y values of data set #n; the x values of
  260.                     the error bar data sets are ignored.
  261.  
  262.   The following commands select the type of 2-D plot for each data set:
  263.  
  264.   LINE n          - Selects a line plot (the default) of data set #n
  265.                     inwhich successive data points are connected by
  266.                     straight lines.
  267.   SPLINE n        - Selects a natural cubic spline plot of data set #n
  268.                     inwhich successive data points are connected by a
  269.                     smooth curve.
  270.   CURVE n         - Selects a smooth curve plot of data set #n using a
  271.                     proprietary method that does not oscillate as much
  272.                     as a spline curve.
  273.   SYMBOLS n       - Specifies that symbols are to be drawn at the data points
  274.                     of data set #n along with the connecting lines or curve.
  275.   SCATTER n       - Selects a scatter plot of data set #n with just the
  276.                     symbols for the data points and without the
  277.                     connecting lines or curve.
  278.   SPIKES n        - Specifies that vertical spikes are to be drawn to the
  279.                     data points of data set #n along with the connecting
  280.                     lines or curve.
  281.   HISTOGRAM n     - Selects a histogram of data set #n with the data
  282.                     points represented by vertical spikes and without the
  283.                     connecting lines or curve.
  284.   HISTWIDTH value - If "value" is nonzero then histograms will be plotted
  285.                     using bars of width "value" instead of spikes.
  286.   STEP n          - Selects a step plot of data set #n with successive
  287.                     data points connected by horizontal steps.
  288.  
  289.   If "n" is omitted from any of the above commands then the command applies
  290.   to all data sets; "n-m" (with no spaces) specifies data sets n to m.
  291.  
  292.   NOTE:  In order to make a spline or curve plot the x values must be
  293.          in ascending order.
  294.  
  295.   Multiple sets of plotted data that correspond to different orders of
  296.   magnitude or different ranges can be compared by using the z axis as a
  297.   second vertical axis on the right side of a 2-D plot (see USEZ command)
  298.   or by using the following commands:
  299.  
  300.   SCALEX value n  - Multiplies the x values in data set #n by "value".
  301.   OFFSETX value n - Adds "value" to the x values of data set #n.
  302.   SCALEY value n  - Multiplies the y values in data set #n by "value".
  303.   OFFSETY value n - Adds "value" to the y values in data set #n.
  304.   SCALEZ value    - Multiplies the z values by "value".
  305.   OFFSETZ value   - Adds "value" to the z values.
  306.  
  307.   If "n" is omitted from any of the above commands then it defaults to
  308.   all data sets; this feature can be used to scale the data to keep
  309.   scientific notation from being used in axes tic mark labels.
  310.  
  311.   A new data set can be generated from a mathematical transformation of one
  312.   or more existing data sets by entering a function in the following format:
  313.  
  314.   Y(Xn) = function of (Xn, Y1, Y2, ..., Yn, ..., Ym)
  315.  
  316.   Example:  Y(X1) = (Y2-Y1)^2 / SQRT( 1 + X1 )
  317.  
  318.   The function Y(Xn) must be set equal to an expression that can contain
  319.   constants, the symbol PI, variables Xn, Y1, Y2, ..., Ym, the operators
  320.   "+" (addition), "-" (substraction), "*" (multiplication), "/" (division)
  321.   and "^" (exponentiation) and parentheses.  The expression can also
  322.   contain the following elementary functions:
  323.  
  324.      ABS(x)    Absolute Value.
  325.      SQRT(x)   Square Root.
  326.      EXP(x)    Exponential (e to the power of x).
  327.      LOG(x)    Logarithm (base e).
  328.      LOG10(x)  Logarithm (base 10).
  329.      COS(x)    Cosine.
  330.      SIN(x)    Sine.
  331.      TAN(x)    Tangent.
  332.      ACOS(x)   Arccosine.
  333.      ASIN(x)   Arcsine.
  334.      ATAN(x)   Arctangent.
  335.      COSH(x)   Hyperbolic Cosine.
  336.      SINH(x)   Hyperbolic Sine.
  337.      TANH(x)   Hyperbolic Tangent.
  338.      SINC(x)   Sin(x) / x.
  339.      RND()     Random Number (between 0 and 1).
  340.      U(x)      Unit Step Function.
  341.      ERF(x)    Error Function.
  342.      INVERF(x) Inverse Error Function.
  343.      J0(x) to J6(x)  Bessel Functions of the First Kind.
  344.  
  345.   The Y variables (Y1, Y2, ..., Ym) represent the Y values of m different data
  346.   sets.  The Y values of all data sets that appear in the expression must
  347.   correspond to the same X values, represented by a single X variable (Xn).
  348.   The X variable specified as the function argument (Xn) is the only X variable
  349.   that can appear in the expression.  The expression is evaluated at each of
  350.   the X values in data set #n.  In the above example, the Y values of both
  351.   data set #1 and data set #2 (represented by the variables Y1 & Y2) must
  352.   correspond to the X values in data set #1 (represented by the variable X1);
  353.   this would be true, for example, if the data sets were read with the READTAB
  354.   command.
  355.  
  356.   A function of a single independent variable can be graphed by entering
  357.   the function in the following format:
  358.  
  359.   Y(X) = function of X
  360.  
  361.   Example:  Y(X) = 1 + 2 * EXP(-X^2) * SIN(PI*X)
  362.  
  363.   The function Y(X) must be set equal to an expression inwhich X is the only
  364.   independent variable.  A new data set will be generated by evaluating the
  365.   function at even intervals of X between starting and ending values specified
  366.   by the XSTART and XEND commands:  XSTART ≤ X ≤ XEND.  The number of sample
  367.   points (which defaults to 201) can be specified with the following command:
  368.  
  369.   XSAMPLES n
  370.  
  371.   Three dimensional data can be generated by entering a function of
  372.   two independent variables in the format:
  373.  
  374.   Y(X,Z) = function of (X,Z)
  375.  
  376.   Example:  Y(X,Z) = SINC( SQRT( X*X + Z*Z ) )
  377.  
  378.   The function will be evaluated at even intervals of Z between starting and
  379.   ending values specified by the ZSTART and ZEND commands:  ZSTART ≤ Z ≤ ZEND.
  380.   The number of Z sample points (which defaults to 51) can be specified with
  381.   the following command:
  382.  
  383.   ZSAMPLES n
  384.   
  385.   If a function is sampled for the purpose of finding its FFT then the last
  386.   end point should not be included.  The following command excludes the the
  387.   last end point, i.e., XSTART ≤ X < XEND and ZSTART ≤ Z < ZEND:
  388.  
  389.   ENDPOINT OFF
  390.  
  391.   Each of the three types of functions, Y(X), Y(X,Z), and Y(Xn), can be set
  392.   equal to expressions that contain intermediate variables T1, T2, ... T9.
  393.  
  394.   Example:  T1 = 1 + X
  395.             T2 = sin( 2 * X )
  396.             Y(X) = 1 + T2 / T1 + ( 1 - X * T2 ) / ( T1 * T1 )
  397.  
  398.   The intermediate variables are not evaluated and are not checked for errors
  399.   until a function specification is used to generate a new data set; then, at
  400.   each point at which the function is to be evaluated, the intermediate
  401.   variables are first evaluated in the order T1, T2, ... T9 then the function
  402.   is evaluated.  Note that if an intermediate variable is defined then it will
  403.   be evaluated even if it does not appear in the function's expression.  An
  404.   intermediate variable can be cleared by setting it equal to nothing.
  405.   Example: T1 =
  406.  
  407.   Some more commands for manipulating data sets are:
  408.  
  409.   INTEGRATE n     - Generates the indefinite integral of data set #n using
  410.                     the trapezoidal method of numerical integration.
  411.   DIFFER n        - Generates the derivative of data set #n.
  412.   YYTOXY n m      - Generates a new data set with the x values copied from
  413.                     the y values of data set #n and the new y values copied
  414.                     from the y values of data set #m, i.e., (Yn,Ym) -> (X,Y).
  415.                     If a table of data is input with the READTABY command and
  416.                     plotting of the input data is disabled with the NOPLOT
  417.                     command (described later) then the YYTOXY command can be
  418.                     used to select any pair of columns from the table as a
  419.                     data set to be plotted.
  420.   YTOZ n          - Copies y values of data set #n to z data array.
  421.   COPY x1 x2 n    - Copies points between x1 and x2 from data set #n to
  422.                     a new data set; "COPY 0 0 n" copies all of the data set.
  423.   APPEND m n      - Appends data set #m to end of data set #n and deletes
  424.                     data set #m.
  425.   SWAPXY n        - Swaps x and y values of data set #n.
  426.   REDUCE m n      - Replaces data set #n with averages of successive groups
  427.                     of m data points, i.e., the number of data points is
  428.                     reduced by a factor of 1/m.
  429.   CLRDATA n       - Clears data set #n.  Clears all data sets if "n" is
  430.                     omitted; n-m (no spaces) clears data sets n to m.
  431.   CLRPLOT         - Resets all plot parameters to their default values.
  432.  
  433.   Each set of data is plotted in a different color with EGA/VGA graphics;
  434.   dash lines are used with CGA and Hercules graphics.
  435.  
  436.   COLOR m n       - Specifies that color index "m" be used for drawing
  437.                     axes and labels with EGA/VGA graphics; optionally,
  438.                     the background's color index "n" can also be specified.
  439.   DATACOLOR m n   - Specifies that color index "m" be used for plotting
  440.                     data set #n (or n-k) with EGA/VGA graphics.  "m" can
  441.                     also be specified by using the first two letters of the
  442.                     following color names: BLue, GReen, CYan, REd, MAgenta,
  443.                     BRown, WHite, DGray, LBlue, LGreen, LCyan, LRed, LMagenta,
  444.                     YEllow, BWhite (D=Dark, L=light, B=Bright).  A simple way
  445.                     of handling color is to put your choice of color commands
  446.                     in a command file, COLOR.PLT for example, then put the
  447.                     command "DO COLOR.PLT" in all other command files or type
  448.                     it interactively.  The DATACOLOR command with no parameters
  449.                     sets the colors back to the default colors.
  450.   SYMTYPE m n     - Specifies that symbol type "m" be used to plot data point
  451.                     symbols for data set #n (or n-k). "m" can be one of the
  452.                     following number or two-letter codes:
  453.                        1  SQ  Square
  454.                        2  DI  Diamond
  455.                        3  CR  Cross
  456.                        4  CI  Circle
  457.                        5  AD  Arrow Down
  458.                        6  AR  Arrow Right
  459.                        7  AU  Arrow Up
  460.                        8  AL  Arrow Left
  461.                        9  HG  Hour Glass
  462.                       10  BO  Bow
  463.                       11  DO  Dot
  464.                     The SYMTYPE command with no parameters sets the symbol
  465.                     types back to the default types.
  466.   DASH ON         - Enables dashed lines (default for CGA & Hercules).
  467.   DASH OFF        - Disables dashed lines (default for EGA/VGA).
  468.  
  469.   The following commands are used to specify a title, axes labels and
  470.   data set legends:
  471.  
  472.   XLABEL text     -  The character string "text" will be printed below
  473.                      the x-axis.
  474.   YLABEL text     -  The character string "text" will be printed to the
  475.                      left of the y-axis.
  476.   ZLABEL text     -  The character string "text" will be printed to the
  477.                      right of the z-axis on 3-D plots (or 2-D plots
  478.                      with a second vertical axis).
  479.   TITLE text      -  The character string "text" will be printed above
  480.                      the plot.
  481.   LEGENDn x y text - The legend "text" associated with data set #n will
  482.                      be printed at coordinate (x,y).
  483.  
  484.   The LEGENDn coordinate (x,y) is the coordinate of the lower left corner
  485.   of the first character in the text.  The coordinate values are specified
  486.   as fractions of axis length and are normally between 0. and 1., i.e.,
  487.   (0.,0.) is at the origin, (1.,0.) is at the end of the x-axis and (0.,1.)
  488.   is at the top of the y-axis.  The legend coordinates are screen coordinates;
  489.   the legends are not repositioned if the origin or axes scales are changed.
  490.   LEGEND1, LEGEND2, ..., LEGEND9 are associated with data sets 1 to 9,
  491.   respectively, and LEGEND0 is associated with data set 10; only the first 10
  492.   data sets can be given legends.  The legends are displayed using the same
  493.   colors used to plot the corresponding data sets with EGA/VGA graphics; if no
  494.   data set corresponds to a legend then the axes color is used.  Legends are
  495.   displayed on 2-D plots only.
  496.  
  497.   Rather than use the LEGENDn command, an easier way to display a
  498.   legend for data set #n is to manually place the legend on the plot.
  499.   After the plot is drawn:
  500.  
  501.     (1) Press function key Fn.
  502.     (2) Move the cursor to the desired position on the screen.
  503.     (3) Type the text of the legend.
  504.     (4) Press the RETURN key.
  505.  
  506.   The cursor appears after a function key has been pressed; it disappears
  507.   after the RETURN key has been pressed.  The arrow keys will move the
  508.   cursor in pixel increments; the HOME and END keys will move the cursor
  509.   left and right in character increments and the PgUp and and PgDn keys will
  510.   move the cursor up and down in character increments.  The cursor can also
  511.   be moved with a mouse.  If the plot is saved with the SAVE command
  512.   (described later) then the legends entered on the screen will be saved as
  513.   LEGENDn commands.  If just one function key is used to enter more than one
  514.   legend then only the last one entered is saved.  Legends can be temporarily
  515.   disabled or cleared with the following commands:
  516.  
  517.   LEGENDS OFF     - Disables display of legends.
  518.   LEGENDS ON      - Enables display of legends.
  519.   LEGENDS CLR     - Clears all legends.
  520.  
  521.   If the first character in a legend is an "*" then the asterisk will actually
  522.   be displayed as a data point symbol provided the corresponding data points
  523.   plot as symbols (specified by the SYMBOLS or SCATTER commands) and a specific
  524.   symbol type has been selected with the SYMTYPE command.
  525.  
  526.   A 2-Dimensional plot will be made when the end of the command file is
  527.   reached or the following command is read:
  528.  
  529.   PLOT            - Makes a 2-Dimensional plot.
  530.  
  531.   IMPORTANT NOTE: The plot will be cleared from the screen when the ESC key
  532.                   (or right mouse button) is pressed.
  533.  
  534.             NOTE: Pressing the RETURN key (or left mouse button) when the
  535.                   plot is displayed will call up a pair of crosshairs.  The
  536.                   crosshairs can be moved with the arrow keys and the HOME,
  537.                   END, PageUp and PageDown keys or with a mouse.  Each
  538.                   subsequent press of the RETURN key (or left mouse button)
  539.                   will display the X and Y values associated with the point
  540.                   at the center of the crosshairs.  Press any other key to
  541.                   clear the crosshairs.  This feature works only with 2-D
  542.                   plots with a single vertical axis.
  543.  
  544.   USEZ n        - Data set #n will be plotted using the z axis as a second
  545.                   vertical axis on right side of a 2-D plot; n-m (no spaces)
  546.                   makes data sets n to m plot on the second vertical axis.
  547.                   The scale of the second vertical axis is set by ZSTART,
  548.                   ZEND & ZSTEP and the axis label is set by ZLABEL.  The
  549.                   list of data sets that plot on the second vertical axis is
  550.                   cleared with "USEZ".
  551.  
  552.   NOPLOT n      - Data set #n (or sets n-m) will not be plotted; it is not
  553.                   deleted and can still be manipulated.  The list of disabled
  554.                   data sets is cleared with "NOPLOT".
  555.  
  556.   A 3-Dimensional plot will be made when one of the following commands is
  557.   read:
  558.  
  559.   PLOT3D          - Makes a 3-Dimensional plot of multiple x-y data sets
  560.                     with the z axis a parameter axis.
  561.   PLOT3D SURFACE  - Makes a 3-Dimensional plot of multiple x-y data sets
  562.                     representing curves on a surface y = f(x,z).
  563.   PLOT3D CURVE    - Makes a plot of a 3-Dimensional curve.
  564.   PLOT3D SCATTER  - Makes a 3-Dimensional scatter plot.
  565.  
  566.   Each x-y data set will correspond to a point on the z axis.  If z
  567.   values were read with the READZ command then the kth x-y data set will
  568.   correspond to the kth z value.  The z values must be in ascending
  569.   order.  If no z values were read then the x-y data sets will be plotted
  570.   at even intervals along the z axis.  With a normal 3-D plot the data
  571.   sets are plotted in different colors.   With a surface 3-D plot all
  572.   data sets are plotted with the same color using a different hidden line
  573.   algorithm that allows the bottom of the surface to be visible as well
  574.   as the top.
  575.  
  576.   With a surface 3-D plot each data set is assumed to contain the points
  577.   of a curve on the surface that corresponds to a constant value of z,
  578.   i.e., Y = f(X,Zk) where Zk is the value of z that corresponds to the
  579.   kth data set containing the x and y values.  If all data sets contain
  580.   the same sequence of x values (i.e., the data values are points on a
  581.   rectangular grid) then the easiest way of reading the points on the
  582.   surface is to use a READTAB command and a READZ command:
  583.  
  584.    READTAB m n
  585.    X1 Y11 Y12 ... Y1m
  586.    X2 Y21 Y22 ... Y2m
  587.    .              .
  588.    :              :
  589.    Xn Yn1 Yn2 ... Ynm
  590.    READZ m
  591.       Z1  Z2 ...  Zm
  592.  
  593.   A 3-D curve is plotted as as sequence of (x,y,z) values inwhich the x-y
  594.   values were read as data set #1 using the READ command and the z values
  595.   were read using the READZ command.  The (x,y,z) values can also be read
  596.   using the READXYZ command (or the READZXY command).
  597.  
  598.   If a group of (x,y,z) values contained in data set #1 and z is plotted
  599.   as a 3-Dimensional scatter plot then a symbol is drawn at each data
  600.   point along with a vertical line connecting the symbol to the xz plane.
  601.  
  602.   A different view of the a 3-D plot can be specified with the following
  603.   command:
  604.  
  605.   ROTATE          - Next 3-D plot will be rotated 90 degrees.
  606.   ROTATE OFF      - Next 3-D plot will be displayed using the normal
  607.                     view.
  608.  
  609.   Equally spaced y data values can be plotted as a bar graph with the
  610.   following command:
  611.  
  612.   BAR             - Makes a bar graph of equally spaced y data values.
  613.  
  614.   If multiple sets of data are to be plotted as a bar graph then all of
  615.   the data sets must have the same number of data points.  A maximum of
  616.   25 data points can be plotted as a bar graph.  If no character strings
  617.   were read with the READBARX command as the x value labels then the
  618.   x-axis is labeled using the values specified by the "XSTART" and
  619.   "XSTEP" commands; if the the XSTEP value is zero then the x-axis is
  620.   labeled as 1, 2, 3, ...
  621.  
  622.   The following are some miscellaneous commands that are useful when entered
  623.   interactively at the keyboard:
  624.  
  625.   HELP          - Displays a summary of the plot commands.
  626.   SHOW          - Displays the current status of plot parameters.
  627.   DO filename   - Executes the plot commands in file "filename".
  628.   SAVE filename - Saves to the file "filename" the data and plot commands
  629.                   that will redisplay the last displayed plot when the
  630.                   "DO filename" command is given.  If the filename is
  631.                   omitted then it defaults to "SAVE.PLT". If the file
  632.                   already exists it is overwritten.
  633.   DOS command   - Executes the specified DOS command; a copy of
  634.                   COMMAND.COM must be accessible by the system.
  635.   EDIT n        - Invokes a user supplied editor to edit data set #n.
  636.                   Before starting the SPLOT program, the name of the
  637.                   editor must be specified with the DOS command "SET
  638.                   SPEDIT=editor".  For example, "SET SPEDIT=EDLIN"
  639.                   specifies that the DOS EDLIN editor will be used; a
  640.                   path to the editor must also be specified.  The EDIT
  641.                   command will write data set #n to the temporary file
  642.                   SPLOTDAT.TMP in the default directory then invoke the
  643.                   specified editor to edit the file.  After the editor
  644.                   terminates, the SPLOT program reads the data back in
  645.                   from the file then deletes the file SPLOTDAT.TMP and
  646.                   the file SPLOTDAT.BAK.  The edited data set must not
  647.                   contain more than 100 additional data points.
  648.   QUIT          - Terminates the program.
  649.  
  650.   The DOS memory resident program GRAPHICS will dump a plot to a dot
  651.   matrix printer when the Shift and PrtSc keys are simultaneously pressed;
  652.   the program must have been previously installed with the DOS command
  653.   "GRAPHICS".  Some versions of the GRAPHICS program will only draw the
  654.   plot sideways and will not work with EGA, VGA or Hercules graphics.  The
  655.   memory resident program PLOTDUMP (which comes with the SPLOT software)
  656.   draws the plot sideways or right side up and will work with CGA, EGA, VGA
  657.   or Hercules graphics.  It can output the plot to an Epson or IBM proprinter
  658.   compatible dot matrix printer or an HP LaserJet compatible laser printer.
  659.   It is installed with the command "PLOTDUMP" and is invoked by simultaneously
  660.   pressing the Ctrl and PrtSc keys or with a software interrupt; see file
  661.   PLOTDUMP.DOC for more details.  If plot dumps are made often then the
  662.   PLOTDUMP command should be placed in the PC's AUTOEXEC.BAT file (the file
  663.   PLOTDUMP.COM must be in the root directory or a path must be specified to
  664.   the directory containing the file).
  665.  
  666.   AUTODUMP      - Causes each plot to be dumped to a printer by automatically
  667.                   calling PLOTDUMP after each plot.
  668.   DUMPINT n     - Specifies PLOTDUMP interrupt number (60 to 65); command must
  669.                   be given before AUTODUMP command if PLOTDUMP interrupt number
  670.                   is other than 60.
  671.   PRINTFF       - Outputs a formfeed to the printer each time the command is
  672.                   given.
  673.  
  674.   PLEASE NOTE: In order to dump a plot to a printer the PLOTDUMP program must
  675.                be installed in memory before making the plot.
  676.  
  677.  
  678.                             EXAMPLES
  679.  
  680.   Suppose the file EXAMPLE.PLT contains the following commands:
  681.  
  682.   title Example Plot
  683.   xlabel This is the x axis
  684.   ylabel This is the y axis
  685.   xstart 5
  686.   xend 15
  687.   xstep 2.5
  688.   ygrid
  689.   open data2.dat
  690.   read 16
  691.   read
  692.   open data1.dat
  693.   read
  694.   close
  695.   read 12
  696.   6  178    7 193   7.5 212    8 243    8.5 365   9.5 185
  697.   10  72   12  43  12.5 150   13 240   13.5 30    14  85
  698.   symbols 3
  699.   symbols 4
  700.   plot
  701.  
  702.   And suppose data file DATA2.DAT contains:
  703.  
  704.     5   30     6   40    7  70    8    120
  705.     9  250    9.5 450   10 800   10.25 900
  706.   10.5 950  10.75 880   11 700   11.5  290
  707.   12   150    13   80   14  50    15    40
  708.  
  709.    5  980    6 980     7  980   8  950    8.5 900    9 800
  710.   9.5 500   10 400   10.5 300   11 250   11.5 220   12 200
  711.   13  200   14 200     15 200
  712.  
  713.   And suppose data file DATA1.DAT contains:
  714.  
  715.   4 50   6 75   8 125   10 275   12 575   14 950
  716.  
  717.   A plot will be displayed by typing "SPLOT EXAMPLE.PLT" at the DOS
  718.   prompt. The x and y axes will be labeled and the plot will be titled.
  719.   The x-axis will be linear by default and will range from 5 to 15 and
  720.   be labeled in increments of 2.5. By default the program SPLOT will
  721.   set the scale of the y-axis which will also be linear. Horizontal grid
  722.   lines will be drawn. Four sets of data will be plotted. The first set
  723.   of data will consist of 16 data points read from file data2.dat. The
  724.   second set of data will be all of the remaining data in file
  725.   data2.dat. The third set of data will be read from file data1.dat.
  726.   The fourth set of data will be the 12 data points in the command
  727.   file. All four sets of data will be plotted as line plots. Symbols
  728.   will be drawn at the data points in the third and fourth sets of data.
  729.  
  730.   The data in the following command file will be plotted at even
  731.   intervals on the X-axis using a log Y-axis:
  732.  
  733.   title Example Log Plot
  734.   xlabel X
  735.   ylabel Y
  736.   logy
  737.   ready 24
  738.   2.1  2.9  3.3  3.8  4.6  6.2  8.3  12.4  17.1  29.3  53.7  75.4
  739.   92.1 62.3  25.4  15.2  11.2  7.4  5.9  4.1  3.6  2.8  2.3  1.95
  740.   plot
  741.  
  742.   The following commands will produce a 3rd degree polynomial curve fit:
  743.  
  744.   title Third Degree Polynomial Curve Fit
  745.   xlabel X
  746.   ylabel Y
  747.   read 10
  748.   .5  3     1.5  7    2.5  12.5   5.5 14.5   6.5 16
  749.   9.5 14.5  10.5 16   12.5 16    14.5 21    15.5 23
  750.   poly 3
  751.   plot
  752.  
  753.   Other examples can be found in the files with a PLT extension.
  754.   ---------------------------------------------------------------------------
  755.  
  756.                    SPLOT SOFTWARE LICENSE AGREEMENT
  757.  
  758.   The SPLOT software (programs SPLOT, HPLOT and PLOTDUMP and all
  759.   documentation and examples) is copyrighted by the author.  If you find
  760.   the SPLOT software useful please send payment of $20.00 to the author:
  761.  
  762.                         William G. Hood
  763.                         711 Mitchell
  764.                         Conway, AR 72032 (USA)
  765.  
  766.   The SPLOT software is protected by copyright law; it is not public
  767.   domain.  You are granted a limited license to have possession of an
  768.   unpaid for copy of the SPLOT software for the purpose of evaluation of
  769.   the software and a license to make and freely give away unmodified
  770.   copies for the purpose of evaluation of the software by others.  The
  771.   software may not be sold, separately or in conjunction with any other
  772.   software or hardware, without written permission of the author; a
  773.   reasonable (under $10) media and handling fee may be charged for
  774.   diskettes or other media containing the software or for access to the
  775.   software on bulletin boards.
  776.  
  777.   Actual use of the SPLOT software, other than for reasonable evaluation
  778.   purposes, without payment of $20.00 to the author is a copyright
  779.   violation.  Payment of $20.00 entitles a single user to use the SPLOT
  780.   software.
  781.  
  782.   Those who have previously paid for the right to use a previous major
  783.   version of the SPLOT software can purchase the right to use the current
  784.   version for $10.00.
  785.  
  786.   The software is provided "AS IS" without warranty of any kind, either
  787.   expressed or implied.
  788.   ---------------------------------------------------------------------------
  789.  
  790.                      SPLOT VERSION NUMBER: 7.85
  791.  
  792.        Send payment to:   William G. Hood
  793.                           711 Mitchell
  794.                           Conway, AR 72032 (USA)
  795.  
  796.   [ ]  Payment by check of ________ for a license for ____ (1 to 4) users
  797.        to use the SPLOT software @ $20.00 / user ($10.00 / user if you have
  798.        already paid for version 5.x or 6.x; no additional charge if you have
  799.        already paid for version 7.x).
  800.  
  801.   [ ]  Payment by check of ________ for a license for ____ (5 to 9) users
  802.        to use the SPLOT software @ $15.00 / user.
  803.  
  804.   [ ]  Payment by check of ________ for a license for ____ (10 to 24) users
  805.        to use the SPLOT software @ $10.00 / user.
  806.  
  807.   [ ]  Payment by check of $250.00 for a license for an unlimited number
  808.        of users of the SPLOT software (within a single organization).
  809.  
  810.   [ ]  Payment by check of $30.00 for a single user license and a floppy
  811.        diskette containing the SPLOT software (version 7.85 or later).
  812.  
  813.        Type of diskette drive:  [ ] 360K 5.25"
  814.                                 [ ] 1.2M/360K 5.25"
  815.                                 [ ] 720K 3.5"
  816.                                 [ ] 1.44M/720K 3.5"
  817.  
  818.   [ ]  Payment by check of $450.00 for a floppy diskette containing the
  819.        source code (in C and assembler language) and a license to use
  820.        the source code with software written by the license holder.
  821.  
  822.  
  823.   Name:    ________________________________________________________________
  824.  
  825.   Company: ________________________________________________________________
  826.  
  827.   Address: ________________________________________________________________
  828.  
  829.            ________________________________________________________________
  830.  
  831.            ________________________________________________________________
  832.  
  833.   Phone:   ___________________________
  834.  
  835.   Comments and Suggestions: _______________________________________________
  836.  
  837.            ________________________________________________________________
  838.  
  839.            ________________________________________________________________
  840.  
  841.            ________________________________________________________________
  842.  
  843.            ________________________________________________________________
  844.  
  845.            ________________________________________________________________
  846.